v1.70.0: Release 1.70.0

Compare Source

Behavior Changes

• client: reject service configs containing an invalid retryPolicy in accordance with gRFCs A21 and A6. (#​7905)
  • Note that this is a potential breaking change for some users using an invalid configuration, but continuing to allow this behavior would violate our cross-language compatibility requirements.

New Features

• xdsclient: fallback to a secondary management server (if specified in the bootstrap configuration) when the primary is down is enabled by default. Can be disabled by setting the environment variable GRPC_EXPERIMENTAL_XDS_FALLBACK to false. (#​7949)
• experimental/credentials: experimental transport credentials are added which don't enforce ALPN. (#​7980)
  • These credentials will be removed in an upcoming grpc-go release. Users must not rely on these credentials directly. Instead, they should either vendor a specific version of gRPC or copy the relevant credentials into their own codebase if absolutely necessary.

Bug Fixes

• xds: fix a possible deadlock that happens when both the client application and the xDS management server (responsible for configuring the client) are using the xds:/// scheme in their target URIs. (#​8011)

Performance

• server: for unary requests, free raw request message data as soon as parsing is finished instead of waiting until the method handler returns. (#​7998)
  • Special Thanks: @​lqs

Documentation

• examples/features/gracefulstop: add example to demonstrate server graceful stop. (#​7865)

v1.69.4: Release 1.69.4

Compare Source

Bug Fixes

• rbac: fix support for :path header matchers, which would previously never successfully match (#​7965).

Documentation

• examples/features/csm_observability: update example client and server to use the helloworld service instead of echo service (#​7945).

v1.69.2: Release 1.69.2

Compare Source

Bug Fixes

• stats/experimental: add type aliases for symbols (Metrics/etc) that were moved to the stats package (#​7929).
• client: set user-agent string to the correct version.

v1.69.0: Release 1.69.0

Compare Source

Known Issues

• The recently added grpc.NewClient function is incompatible with forward proxies, because it resolves the target hostname on the client instead of passing the hostname to the proxy. A fix is expected to be a part of grpc-go v1.70. (#​7556)

New Features

• stats/opentelemetry: Introduce new APIs to enable OpenTelemetry instrumentation for metrics on servers and clients (#​7874)
• xdsclient: add support to fallback to lower priority servers when higher priority ones are down (#​7701)
• dns: Add support for link local IPv6 addresses (#​7889)
• The new experimental pickfirst LB policy (disabled by default) supports Happy Eyeballs, interleaving IPv4 and IPv6 address as described in RFC-8305 section 4, to attempt connections to multiple backends concurrently. The experimental pickfirst policy can be enabled by setting the environment variable GRPC_EXPERIMENTAL_ENABLE_NEW_PICK_FIRST to true. (#​7725, #​7742)
• balancer/pickfirst: Emit metrics from the pick_first load balancing policy (#​7839)
• grpc: export MethodHandler, which is the type of an already-exported field in MethodDesc (#​7796)
  • Special Thanks: @​mohdjishin

Bug Fixes

• credentials/google: set scope for application default credentials (#​7887)
  • Special Thanks: @​halvards
• xds: fix edge-case issues where some clients or servers would not initialize correctly or would not receive errors when resources are invalid or unavailable if another channel or server with the same target was already in use . (#​7851, #​7853)
• examples: fix the debugging example, which was broken by a recent change (#​7833)

Behavior Changes

• client: update retry attempt backoff to apply jitter per updates to gRFC A6. (#​7869)
  • Special Thanks: @​isgj
• balancer/weightedroundrobin: use the pick_first LB policy to manage connections (#​7826)

API Changes

• balancer: An internal method is added to the balancer.SubConn interface to force implementors to embed a delegate implementation. This requirement is present in the interface documentation, but wasn't enforced earlier. (#​7840)

Performance Improvements

• mem: implement a ReadAll() method for more efficient io.Reader consumption (#​7653)
  • Special Thanks: @​ash2k
• mem: use slice capacity instead of length to determine whether to pool buffers or directly allocate them (#​7702)
  • Special Thanks: @​PapaCharlie

Documentation

• examples/csm_observability: Add xDS Credentials and switch server to be xDS enabled (#​7875)

v1.68.2: Release 1.68.2

Compare Source

Dependencies

• Remove the experimental stats/opentelemetry module and instead add the experimental packages it contains directly into the main google.golang.org/grpc module (#​7936)

v1.68.1: Release 1.68.1

Compare Source

Bug Fixes

• credentials/alts: avoid SRV and TXT lookups for handshaker service to work around hangs caused by buggy versions of systemd-resolved. (#​7861)

Dependencies

• Relax minimum Go version requirement from go1.22.7 to go1.22. (#​7831)

v1.68.0: Release 1.68.0

Compare Source

Behavior Changes

• stats/opentelemetry/csm: Get mesh_id local label from "CSM_MESH_ID" environment variable, rather than parsing from bootstrap file (#​7740)
• orca (experimental): if using an ORCA listener, it must now be registered only on a READY SubConn, and the listener will automatically be stopped when the connection is lost. (#​7663)
• client: ClientConn.Close() now closes transports simultaneously and waits for transports to be closed before returning. (#​7666)
• credentials: TLS credentials created via NewTLS that use tls.Config.GetConfigForClient will now have CipherSuites, supported TLS versions and ALPN configured automatically. These were previously only set for configs not using the GetConfigForClient option. (#​7709)

Bug Fixes

• transport: prevent deadlock in client transport shutdown when writing the GOAWAY frame hangs. (#​7662)
• mem: reuse buffers more accurately by using slice capacity instead of length (#​7702)
  • Special Thanks: @​PapaCharlie
• status: Fix regression caused by #​6919 in status.Details() causing it to return a wrapped type when getting proto messages generated with protoc-gen-go < v1. (#​7724)

Dependencies

• Bump minimum supported Go version to go1.22.7. (#​7624)

v1.67.3: Release 1.67.3

Compare Source

Dependencies

• Remove the experimental stats/opentelemetry module and instead add the experimental packages it contains directly into the main google.golang.org/grpc module.

v1.67.2: Release 1.67.2

Compare Source

Bug Fixes

• credentials/alts: avoid SRV and TXT lookups for handshaker service to work around hangs caused by buggy versions of systemd-resolved. (#​7861)

v1.67.1: Release 1.67.1

Compare Source

Bug Fixes

• transport: Fix a bug causing stream failures due to miscalculation of the flow control window in both clients and servers. (#​7667)
• xds/server: Fix xDS Server memory leak. (#​7681)

v1.67.0: Release 1.67.0

Compare Source

Bug Fixes

• ringhash: when used with multiple EDS priorities, fix bug that could prevent a higher priority from recovering from transient failure. (#​7364)
  • Special Thanks: @​atollena

Behavior Changes

• In accordance with RFC 7540, clients and servers will now reject TLS connections that don't support ALPN. This can be disabled by setting the environment variable GRPC_ENFORCE_ALPN_ENABLED to false (case insensitive). Please file a bug if you encounter any issues with this behavior. The environment variable to revert this behavior will be removed in an upcoming release. (#​7535)

v1.66.3: Release 1.66.3

Compare Source

Bug Fixes

• transport: Fix a bug causing stream failures due to miscalculation of the flow control window in both clients and servers. (#​7667)
• xds/server: Fix xDS Server memory leak. (#​7681)

v1.66.2: Release 1.66.2

Compare Source

Dependencies

• Remove unintentional dependency on the testing package (#​7579)
• Remove unintentional dependency on the flate package (#​7595)
  • Special Thanks: @​ash2k

Bug Fixes

• client: fix a bug that prevented memory reuse after handling unary RPCs (#​7571)
  • Special Thanks: @​coxley

v1.66.1

Compare Source

v1.66.0: Release 1.66.0

Compare Source

New Features

• metadata: stabilize ValueFromIncomingContext (#​7368)
  • Special Thanks: @​KarthikReddyPuli
• client: stabilize the WaitForStateChange and GetState methods, which were previously experimental. (#​7425)
• xds: Implement ADS flow control mechanism (#​7458)
  • See https://github.com/grpc/grpc/issues/34099 for context.
• balancer/rls: Add metrics for data cache and picker internals (#​7484, #​7495)
• xds: LRS load reports now include the total_issued_requests field. (#​7544)

Bug Fixes

• grpc: Clients now return status code INTERNAL instead of UNIMPLEMENTED when the server uses an unsupported compressor. This is consistent with the gRPC compression spec. (#​7461)
  • Special Thanks: @​Gayathri625
• transport: Fix a bug which could result in writes busy looping when the underlying conn.Write returns errors (#​7394)
  • Special Thanks: @​veshij
• client: fix race that could lead to orphaned connections and associated resources. (#​7390)
• xds: use locality from the connected address for load reporting with pick_first (#​7378)
  • without this fix, if a priority contains multiple localities with pick_first, load was reported for the wrong locality
• client: prevent hanging during ClientConn.Close() when the network is unreachable (#​7540)

Performance Improvements

• transport: double buffering is avoided when using an http connect proxy and the target server waits for client to send the first message. (#​7424)
• codec: Implement a new Codec which uses buffer recycling for encoded message (#​7356)
  • introduce a mem package to facilitate buffer reuse (#​7432)
  • Special Thanks: @​PapaCharlie

v1.65.1: Release 1.65.1

Compare Source

Bug Fixes

• xds/server: Fix xDS Server memory leak. (https://github.com/grpc/grpc-go/pull/7664)

v1.65.0: Release 1.65.0

Compare Source

Dependencies

• Change support policy to cover only the latest TWO releases of Go, matching the policy for Go itself. See #​7249 for more information. (#​7250)
• Update x/net/http2 to address CVE-2023-45288 (#​7282)

Behavior Changes

• credentials/tls: clients and servers will now reject connections that don't support ALPN when environment variable GRPC_ENFORCE_ALPN_ENABLED is set to "true" (case insensitive). (#​7184)
  • NOTE: this behavior will become the default in a future release.
• metadata: remove String method from MD to make printing more consistent (#​7373)

New Features

• grpc: add WithMaxCallAttempts to configure gRPC's retry behavior per-channel. (#​7229)
  • Special Thanks: @​imoore76

Bug Fixes

• ringhash: properly apply endpoint weights instead of ignoring them (#​7156)
• xds: fix a bug that could cause xds-enabled servers to stop accepting new connections after handshaking errors (#​7128)
  • Special Thanks: @​bozaro

v1.64.1: Release 1.64.1

Compare Source

Dependencies

• Update x/net/http2 to address CVE-2023-45288 (#​7352)
• metadata: remove String method from MD to make printing consistent (#​7374)

v1.64.0: Release 1.64.0

Compare Source

API Changes

• stats: Deprecate InPayload.Data and OutPayload.Data; they were experimental and will be deleted in the next release (#​7121)

Behavior Changes

• codec: Remove handling of environment variable GRPC_GO_ADVERTISE_COMPRESSORS to suppress setting supported compressors in grpc-accept-encoding header. Compressors will always be advertised, as they have been by default for some time (#​7203)

New Features

• resolver/dns: Add SetMinResolutionInterval to set the minimum interval at which DNS re-resolutions may occur (#​6962)
  • Special Thanks: @​HomayoonAlimohammadi
• peer/peer: Implement the fmt.Stringer interface for pretty printing Peer, and
• metadata/metadata: Implement the fmt.Stringer interface for pretty printing MD (#​7137)
  • Special Thanks: @​AnomalRoil

Performance Improvements

• client: Improve RPC performance by reducing work while holding a lock (#​7132)

Bug Fixes

• transport/server: Display the proper timeout value when keepalive pings are not ack'd in time (#​7038)
  • Special Thanks: @​BatmanAoD
• channelz: Fix bug that was causing the subchannel's target to be unset (#​7189)
• stats: Fix bug where peer was not set in context when calling stats handler for OutPayload, InPayload, and End (#​7096)

Dependencies

• deps: Remove dependency on deprecated github.com/golang/protobuf module (#​7122)

Documentation

• grpc: Deprecate WithBlock, WithReturnConnectionError, FailOnNonTempDialError which are ignored by NewClient (#​7097)
  • Special Thanks: @​pellared
• grpc: Deprecate Dial and DialContext. These will continue to be supported throughout 1.x, but are deprecated to direct users to NewClient (See #​7090 for more information)
• examples: Add custom lb example (#​6691)

v1.63.3: Release 1.63.3

Compare Source

Dependencies

• Update x/net/http2 to address CVE-2023-45288 (#​7352)

v1.63.2: Release 1.63.2

Compare Source

Bugs

• Fix the user agent string

v1.63.1: Release 1.63.1

Compare Source

• grpc: un-deprecate Dial and DialContext and cherry-pick

v1.63.0: Release 1.63.0

Compare Source

Behavior Changes

• grpc: Return canonical target string from resolver.Address.String() (experimental) (#​6923)
• client & server: when using write buffer pooling, use input value for buffer size instead of size*2 (#​6983)
  • Special Thanks: @​raghav-stripe

New Features

• grpc: add ClientConn.CanonicalTarget() to return the canonical target string. (#​7006)
• xds: implement LRS named metrics support (gRFC A64) (#​7027)
  • Special Thanks: @​danielzhaotongliu
• grpc: introduce grpc.NewClient to allow users to create new clients in idle mode and with "dns" as the default resolver (#​7010)
  • Special Thanks: @​bruuuuuuuce

API Changes

• grpc: stabilize experimental method ClientConn.Target() (#​7006)

Bug Fixes

• xds: fix an issue that would cause the client to send an empty list of resources for LDS/CDS upon reconnecting with the management server (#​7026)
• server: Fix some errors returned by a server when using a grpc.Server as an http.Handler with the Go stdlib HTTP server (#​6989)
• resolver/dns: add SetResolvingTimeout to allow configuring the DNS resolver's global timeout (#​6917)
  • Special Thanks: @​and1truong
• Set the security level of Windows named pipes to NoSecurity (#​6956)
  • Special Thanks: @​irsl

v1.62.2: Release 1.62.2

Compare Source

Dependencies

• Update http2 library to address vulnerability CVE-2023-45288